home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir43 / sayv30.zip / SAY.DOC < prev   
Text File  |  1994-10-05  |  26KB  |  492 lines
  1.     SAY V3.0 is Copy(c)right 1993,1995 by Gary M. Raymond, New Orleans, La.
  2.  
  3.        The most POWERFUL database manager in the WORLD - for its size!
  4.              More powerful utilities in the DiskSave Series by
  5.  
  6.                               Gary M. Raymond
  7.                                 P.O.Box 8184
  8.                            New Orleans, La.  70182
  9.                                (504) 288-6550
  10.                             Compuserve 70613,3165
  11.  
  12.    To avoid all the data storage pitfalls, and to fill a need in my own
  13.    office for a simple yet reliable method of keeping a wide variety of
  14.    information, I developed SAY, a unique but simple free form database.
  15.  
  16.    The biggest advantage of a freeform database is that the data is
  17.    maintained in a standard ascii text file that can be modified by just
  18.    about any Editor or Word Processor with an ascii or plain text
  19.    output. Each line becomes a RECORD. All records can be linked. Each
  20.    character on a line is a FIELD. All FIELDS can be linked. There is no
  21.    limit to the number of records or fields. Any TYPE of data can be
  22.    stored ANYWHERE, in any order in SAY.TXT.
  23.  
  24.    ====================================================================
  25.  
  26.    Files Provided:
  27.    SAY.COM            SAY Utility
  28.    SAY.DOC            This document.
  29.    LICENSE            Legal stuff etc.
  30.  
  31.    System requirements: PC/XT/AT, DOS 2.1 up, 128k+ ram, floppy
  32.    with hard drive, mono or color, any type graphic adapter.
  33.  
  34.    For technical information about these utilities see end of doc.
  35.    ====================================================================
  36.  
  37. Q  What can SAY do for me?
  38. A  SAY can give you immediate access to data without ever leaving the
  39.    the DOS prompt!  That's right!  You never again need to load big
  40.    unruly database application to store or retrieve useful information.
  41.    Now your data can be available via the dos prompt and your
  42.    fingertips.
  43.  
  44. Q  What exactly is SAY?
  45. A  SAY is a very small, yet ultra powerful ascii (text) database manager
  46.    that is written in assembler machine code.  This technique for
  47.    storing and retrieving data is sometimes referred to as a "free form"
  48.    method of database management.
  49.  
  50. Q  Specifically, what are the target uses for SAY?
  51. A  Saving and retrieving ANY kind of text data. This can vary from a
  52.    desktop ROLLERDEX where you keep names, addresses, phone numbers etc.
  53.    to an accounts receivable or payable file.  The only limit is your
  54.    imagination.
  55.  
  56. Q  This sounds interesting, how does it work?
  57. A  First, SAY.COM must be installed in any directory that you have a DOS
  58.    path assigned. Next, you must start building your SAY.TXT database file.
  59.    This file will be created in the root directory of your hard drive.
  60.    SAY.COM both creates and adds data to your database file as well as
  61.    searches your database for information you are looking for. To both
  62.    create and start adding data the syntax is:
  63.  
  64.    C>SAY mary joe williams 123 apple st mytown, la. 23236 504-333-4444 <Enter>
  65.  
  66.    Thats all there is to it!  SAY will create a file called SAY.TXT in
  67.    the root directory of your hard drive with the contents described above
  68.    as the first record. Oh, if you ever forget the various syntax methods
  69.    for searching, adding, sorting etc. just type SAY by itself at the dos
  70.    prompt!
  71.  
  72. Q  Ok, suppose I have a file with several hundred names etc. already
  73.    stored, how do I search for and locate the one I want?
  74. A  EASY!  The mind is a funny tool. 99.99% of the time, you never forget
  75.    every detail about a data entry.  As an example, suppose you made an
  76.    address phone entry for Mary Stevens; you can only recall that Mary
  77.    lives on Apple street and nothing more. No problem, that will be
  78.    sufficient.
  79.  
  80.    C>SAY apple? <Enter>
  81.    [remember, the question (?) mark indicates a search]
  82.  
  83.    Wow! you say, (and believe me, your exclamation is well founded).
  84.    Within a split second, SAY will start spitting out any records (lines
  85.    of text) containing the word "apple" to the screen.
  86.  
  87.    SAY supports dos redirection too. Therefore you have two additional
  88.    options. You may either redirect the output to your line printer or
  89.    to a text file if you desire. The correct syntax for doing this is:
  90.  
  91.    C>SAY apple?>prn           ;note there is NO space between the question
  92.    or                         ;mark (?) and the DOS redirection (>) symbol.
  93.    C>SAY apple?>outdata.txt
  94.  
  95.    If the dos prompt/cursor does not return to the screen within a few
  96.    seconds its possible more than 18 records (or lines of text) were
  97.    located and SAY is waiting for a key stroke to continue. Because dos
  98.    has been redirected, you cannot determine this by viewing the screen.
  99.    So, if this happens, simply hold down the spacebar (or any other
  100.    convenient key) until the system prompt returns.
  101.  
  102. Q  Wait, I know a little about computers and disk file systems. Explain
  103.    exactly how this record keeping is done and how this file operates?
  104. A  The beauty of a free form method of file storage and data acquisition
  105.    lies in the nature of a simple ascii text file sometimes known as a
  106.    sequential access, and or crlf record delimited file. Records can be
  107.    any length (although for practical purposes they should be limited to
  108.    eighty characters - the length of one line on a typical PC monitor).
  109.    The file size can grow to ANY size although once again, there are
  110.    some practical program limits. See remaining documentation.
  111.  
  112. Q  You mean if I already have a standard ascii text file, I could use
  113.    SAY to search and add text data to it?
  114. A  Sure, all you have to do is rename it from xyz.fil to SAY.TXT and
  115.    move it to the root directory where SAY can find it.
  116.  
  117. Q  Refresh my memory, what again is the definition of ascii or text data?
  118. A  Characters with decimal code values of 32 to 127 are called text
  119.    characters.  This includes the upper and lower case american
  120.    alphabet, numerals and most all common types of punctuation.
  121.  
  122. Q  Suppose I want to include graphic characters like ▓, is that possible?
  123. A  Sure. A simple trick to get your keyboard to generate them is as
  124.    follows.  The character illustrated (▓) has a decimal value of 178.
  125.    If you want to include it (or any other) in your database, hold the
  126.    Alt key down, while you key in numbers 1, 7 and 8 from the NUMERIC
  127.    keypad on the right side of your keyboard. Its that easy!  Of course
  128.    I am assuming you have reference to an ascii table (normally included
  129.    in the index of most DOS or printer manuals).
  130.  
  131. Q  Are there any other advantages or limitations of SAY?
  132. A  As is the case with any search algorithm that is based on sequential
  133.    rather than direct record access, its speed. However, I still think
  134.    you will be impressed. SAY also internally converts all input text
  135.    data to UPPERCASE. Therefore all text data is stored as uppercase.
  136.    Therefore it does not matter whether you enter search strings or
  137.    input text in either upper or lower case letters.
  138.  
  139.    A normal binary database is a file (method of storage on disk) that
  140.    uses a highly structured method of saving information. The structure
  141.    begins with a RECORD (similar to a single folder in a file cabinet)
  142.    that may contain many individual pieces of information. Each piece of
  143.    information must however be associated with particular areas of the
  144.    record (called FIELDS) that are limited as to what TYPE of
  145.    information they can hold as well as the size (field data length) of
  146.    the information. The advantages of a conventional database are speed
  147.    of access via ability to index and sort. The disadvantages have
  148.    mostly to do with the complication of the database file itself. Most
  149.    all conventional database files CANNOT be modified with a simple text
  150.    editor like SAY's SAY.TXT database can!
  151.  
  152.    You cannot put information just anywhere in a conventional database
  153.    but are limited to its pre defined structure. You must have a program
  154.    specifically written to accommodate the data file and such programs
  155.    are usually non user friendly (DBase etc).
  156.  
  157.    To avoid all the data storage pitfalls, and to fill a need in my own
  158.    office for a simple yet reliable method of keeping a wide variety of
  159.    information, I developed SAY, a unique but simple free form database.
  160.  
  161.    The biggest advantage of a freeform database is that the data is
  162.    maintained in a standard ascii text file that can be modified by just
  163.    about any Editor or Word Processor with an ascii or plain text
  164.    output. Each line becomes a RECORD. All records can be linked. Each
  165.    character on a line is a FIELD. All FIELDS can be linked. There is no
  166.    limit to the number of records or fields. Any TYPE of data can be
  167.    stored ANYWHERE, in any order in SAY.TXT.
  168.  
  169.    The two most important operations of any database, are the ability to
  170.    INPUT information and OUTPUT information. To better understand how
  171.    SAY works, lets examine the following lines of data that might be
  172.    found in a typical SAY.TXT data file used as a ROLLERDEX. Here is
  173.    a example of a seven line data file.
  174.  
  175.  
  176.    1  ANN MILLER P.O.B. 7772 CENTERVILLE, GA 45434 505-287-8877
  177.    2  BEN HANDSOM 2211 LOVEBIRD AVE PEACHES, CA 77432 718-777-6655
  178.    3  FRED SMITH 321 LANETREE AVE YOURTOWN, MA 76344 212-446-3344
  179.    4  GEORGE JONES 123 APPLE LANE HOMETOWN, GA 45434 504-288-6550
  180.    5  JOE YOUNG 6 STRONG WAY MAPPLETOWN, VA 212-667-6432
  181.    6  SUE HANDCOCK 333 PITCHFORK ROAD BACKROAD, TX 87654 313-777-6754
  182.    7  TED SMITH 8211 LADYBIRD ST WINGS, MS 33298 601-777-9876
  183.  
  184.    Here are the results of various searches.  Pay careful attention
  185.    to the results of the following seven searches.
  186.  
  187.    SAY e?     (Lines 1,2,3,4,5,6,7 are displayed)
  188.    SAY 454?   (Lines 1 and 4 are displayed)
  189.    SAY joe?   (Line 5 is displayed)
  190.    SAY AVE?   (Lines 2,3 are displayed)
  191.    SAY 212?   (Lines 3,5 are displayed)
  192.    SAY TOWN?  (Lines 3,4,5 are displayed)
  193.    SAY young? (Lines 5 is displayed)
  194.  
  195.    With these examples you should have a clear picture of the
  196.    versatility of SAY.COM. Here are some additional hints: If you start
  197.    every line with either zip code, area code or last name, your data
  198.    can become even more organized with the use of SAY's sort feature.
  199.    This is especially useful when you go to print a hard copy of your
  200.    SAY.TXT data file. (Note: SAY is limited to sorting files under 64k
  201.    in length).
  202.  
  203.    The basic ALGORITHM used by SAY is simple:  When you enter a search
  204.    pattern, say "xyz" (remember, case is unimportant) the program begins
  205.    looking for the very first occurrence of "x". When it finds it, it
  206.    then looks to see if "y" follows and so on until the end of the
  207.    search string. If it locates a matching pattern, it displays the line
  208.    it was found in and proceeds to continue looking through the
  209.    remainder of the file, displaying every line (record) it finds a
  210.    match in. Its that simple.
  211.  
  212.    Remember, freeform databases are NOT intended for LARGE amounts of
  213.    data due to the sequential nature of the searches performed. However
  214.    with most modern personal computers running at 4.7mhz or faster it
  215.    will perform nicely on text files of a thousand lines before it
  216.    begins to become noticeable slower.
  217.  
  218. Q  Is there any problem with renaming SAY to a single letter file handle
  219.    like W.COM?
  220. A  No problem, and since SAY was intended to be operated from the DOS
  221.    prompt, it will save you from typing two extra characters when you
  222.    evoke it into operation. Just make sure you have no other single
  223.    character batch files or applications in your DOS path.
  224.  
  225. Q  Gary, SAY is a great little time saver but it would help if it could
  226.    do one extra little operation. Would you consider coding it for me?
  227. A  Yes, I am available for custom projects.  Very minor or cosmetic
  228.    changes to SAY (that take only minutes), I usually do for the cost of
  229.    registration. If you want additional features, I would be happy to
  230.    give you a free quote. Leave me e-mail or call voice.
  231.  
  232.  
  233.    ====================================================================
  234.    V2.0  01/8/94  First public release
  235.    ====================================================================
  236.    V3.0 10/01/94  Major upgrade (SPEED!, Alpha Sort, Search & Delete)
  237.    ====================================================================
  238.  
  239. Q  How do I alpha sort my ascii database file?
  240. A  EASY!  Just type "SAY *" (less quotes) at the system prompt. SAY Ver
  241.    3.0 will now do an ascending alpha sort on its text (ascii) database
  242.    file up to 60k in size.  Speed of sorting is dependent on file size.
  243.    a few seconds for files under 20k to several minutes at 60k.
  244.  
  245. Q  How do I search and delete?
  246. A  EASY!  Just type "SAY johnny!" (less quotes)  at the system prompt.
  247.    SAY Ver 3.0 will search for the first occurrence of "johnny" and ask
  248.    if the indicated record should be deleted.  This process will
  249.    continue until the entire file is scanned for occurrences of
  250.    "johnny". Note: Search and delete works only on files less than
  251.    60k.
  252.  
  253.  
  254.                            ┌─────────┐
  255.                            │ MEMBER  │   Society of
  256.                            │  ┌──────┴──┐ Independent
  257.                            │  │         │   Shareware
  258.                            └──┤    ■    │     Authors
  259.                               │    ║    │
  260.                               └────╨────┘
  261.     This program is produced by a member of the Society of Independent
  262.     Shareware Authors (SISA).    The Society wants to ensure that all valid
  263.     shareware principles actually work for you and SISA members.  The
  264.     principle behind shareware distribution is simple: try before you
  265.     buy.  Society members agree to license all shareware for a minimum of
  266.     10 days, free of charge, to first-time users as an evaluation
  267.     period.  After 10 days, buyers are then obligated to license their
  268.     copy with the Society member.  Society members are obligated to
  269.     provide high quality, useful shareware, but are free to choose
  270.     whatever marketing methods suit their specific needs.  SISA-
  271.     sanctioned marketing methods include: demonstration versions;
  272.     providing printed documentation after purchase; registration keys
  273.     that unlock additional features not necessary to determine basic
  274.     usefulness; and providing bug fixes free of charge.  Any Shareware
  275.     author may become a member of SISA without cost by simply agreeing
  276.     to the above conditions and displaying, at their option, this logo
  277.     in their documentation.
  278.     ====================================================================
  279.  
  280.     WARRANTY:
  281.     Software:
  282.     Gary Raymond warrants that the software contained herein will
  283.     perform in substantial compliance with the documentation
  284.     accompanying the software.  If you report, in writing, a significant
  285.     defect to us, and we are unable to correct it within 90 days of the
  286.     date you report the defect, you may return the software and
  287.     accompanying materials, and we will refund the purchase price.
  288.  
  289.     Diskettes and Documentation:
  290.     Gary Raymond warrants all diskettes and documentation to be free
  291.     of defects in materials for a period of 30 days from the date of
  292.     purchase.  In the event of notification within the warranty period
  293.     of defects in any materials, Gary Raymond will replace the
  294.     defective diskette or documentation.
  295.  
  296.     Remedies:
  297.     The remedy for breach of the warranty shall be limited to
  298.     replacement and shall not encompass any other damages, including but
  299.     not limited to loss of profit, special, incidental, consequential,
  300.     or similar damages, losses, or claims.
  301.  
  302.     DISCLAIMER:
  303.     Gary Raymond specifically disclaims all other warranties, expressed
  304.     or implied, including but not limited to, implied warranties of
  305.     merchantability and fitness for a particular purpose with respect to
  306.     defects in the diskette and documentation, and the program license
  307.     granted herein, in particular, and without limiting operation of the
  308.     program license with respect to any particular application, use, or
  309.     purpose.   In no event shall Gary Raymond be liable for any loss of
  310.     profit or any other commercial damage, including but not limited to
  311.     special, incidental, consequential or other damages.
  312.  
  313.     GOVERNING LAW:
  314.     This statement shall be construed, interpreted, and governed by the
  315.     laws of the State of Louisiana.
  316.     ====================================================================
  317.  
  318.    Registering your copy will help continue the competitive advantages
  319.    of providing economical shareware.  Upon receipt of your payment I
  320.    will provide you with a copy of the latest version and notify you of
  321.    all future upgrades.  Your patronage is appreciated.
  322.  
  323.    My no-nonsense license:
  324.    ------------------------
  325.    Your one-time registration fee will license you to use SAY on
  326.    any number of personal computers owned directly and personally by you
  327.    in any non-commercial environment.
  328.  
  329.    Re-distribution via electronic transmission, or down loading, is
  330.    allowed without further permission.  Re-distribution of the Shareware
  331.    version of SAY, for a fee, is also allowed without further
  332.    permission as long as that cost is limited to no more than two
  333.    dollars per copy, if supplied on any physical disk media.
  334.  
  335.    The assembler source code for SAY.COM is available for sale at $50
  336.    per copy.  The source is based on the A86 assembler / compiler but is
  337.    generic enough to be compatible with most all assemblers with very
  338.    minor changes.
  339.  
  340.    Yes Gary, I can really make use of your program and would like to
  341.    register and obtain the latest version as well as get on your mailing
  342.    list for future upgrades and new releases!
  343.  
  344.    Product:
  345.    --------
  346.    SAY V3.0 ...........  Private User License USA only.......... $5.00
  347.    Registered users will be disked the latest version, will be entitled
  348.    to any bug fixes free of charge, and receive a free disk containing
  349.    all of my other nifty shareware programs and utilities on approval.
  350.    See the listing below for more information about my other shareware
  351.    products.
  352.  
  353.    For information about commercial and/or multiple site licensing,
  354.    contact the undersigned.
  355.  
  356.    Name_____________________________________________________________
  357.  
  358.    Mailing Address__________________________________________________
  359.  
  360.    City & State ___________________________________________________
  361.  
  362.    ZIP _____________________________ Phone _________________________
  363.  
  364.    Send registration check or money order to:
  365.  
  366.                               Gary M. Raymond
  367.                                 P.O.Box 8184
  368.                             New Orleans, La. 70182
  369.                                 504-288-6550
  370.                             Compuserve 70613,3165
  371.    ====================================================================
  372.  
  373.     TECH DATA:
  374.     ----------
  375.     There is nothing very mysterious about the internal working of SAY.
  376.     All output functions use native DOS services to allow for
  377.     redirecting the output to a printer or a file. SAY treats all file
  378.     character data as a single record up to the crlf. (carriage return -
  379.     linefeed). There is no limit to the size of file that SAY will
  380.     search other than your disk space and your patience. SAY uses less
  381.     than 3k of memory. SAY is no longer CPU speed driven and will produce
  382.     optimum results on most any processor.
  383.     ====================================================================
  384.     Several upgrades are included in Version 3.0  First, a dramatic
  385.     increase in search and locate speed, eliminating the need for fast
  386.     processor speeds to obtain fast searches. Second, a new alpha SORT
  387.     function to help organize your file into rows of alphabetical
  388.     records (lines). And finally, a new search and delete function for
  389.     removing unwanted records (lines) from the text (ascii) database.
  390.  
  391.  
  392.     MANY OTHER USEFUL PROGRAMS, DATABASES AND UTILITIES FROM SLICWARE!
  393.     ===================================================================
  394. SLICK65  EXE  Join On-Line Electronic Services today using SLICK modem
  395.               terminal. SLICK is used by everyone. SLICK has many powerful and
  396.               exciting features not found in other communications programs.
  397.               Example: SLICK has a built in GIF viewer for 256 color SVGA and
  398.               VGA graphic images. Plus, SLICK supports all the popular file
  399.               protocols such as X, Y and Zmodem and others. SLICK has a very
  400.               easy to learn script language for automating your logons. SLICK
  401.               is easy to install and pre configured for COM2 at 1200 baud,
  402.               however any default can be changed on the fly.
  403.  
  404. CLUBCON4 EXE  Great MONEYMAKER, dating, matchmaking software, used worldwide.
  405.               Compatible with Dbase3 or 4. Everything you need to get started.
  406.               Sample database and search info included to tutor and guide you.
  407.               If you are thinking about a computer bases business, this is it!
  408.  
  409. EZBBSV11 EXE  Feature packed BBS system that sets up in less than five minutes!
  410.               Great system for first time sysops. Easy but feature packed. Uses
  411.               ordinary ascii text files as data files for fast maintenance.
  412.  
  413. EZCASHV1 EXE  Easy to use CASH Register program, ideal for small businesses.
  414.               Compatible with Dbase3 or 4. Sets up quickly and user friendly!
  415.  
  416. EZPV11   EXE  External Protocol Engine supports SeaLink, X, Y and Zmodem. Great
  417.               way to upload or download files when stuck with a dumb terminal
  418.               that supports no internal protocols. Or, for that terminal that
  419.               is missing SeaLink, Zmodem or Ymodem B/G.
  420.  
  421. PAGEIT18 EXE  SAVE Money, dispatch your own messages to Alpha Numeric Pagers.
  422.               Requires modem capable of operating at 300 baud and your PC.
  423.  
  424. PCM_V13  EXE  Corporations! Quietly monitor PC work station productivity. This
  425.               is a very powerful utility for determining the need of a pc at a
  426.               particular work station in a large company. Excellent tool for
  427.               company pc managers.
  428.  
  429. READV12  EXE  Ascii Text Viewer that FINDS the file you want to read. Can use
  430.               mouse. Great for those having to read text files daily.
  431.  
  432. SHOWV20  EXE  Convert your ascii text files to Electronic Magazine format.
  433.               Makes it easy to distribute your memos, notices, letters,
  434.               documentation etc. Many unique features allow you to Find, Goto,
  435.               Write to a file, Print, change colors etc. Easy to use.
  436.  
  437. ATZ-V12  EXE  Dial your phone, control your Modem, all from the DOS prompt!
  438.               Works on all four standard IBM default COM ports. NOT a tsr.
  439.  
  440. SLICKPRO EXE  Easy to use ascii text editor with directory directory file
  441.               point and load feature. Emulates most Word Star key commands.
  442.  
  443. SWAPORT1 EXE  BIOS Serial utility for reading or swapping com port addresses.
  444.               Useful utility to get various games and terminals working ok.
  445.  
  446. COPYNOT2 EXE  PREVENTS any unauthorized person from removing files from
  447.               your workstation. Simple to setup and just seconds to use.
  448.  
  449. DISKSAV2 EXE  If you are one of those people who keep promising to do
  450.               BACKUPS, this is for you. Some protection is better than none!
  451.  
  452. SMTV11   EXE  The DO IT ALL script driven communications terminal. Ideal
  453.               to set up for students to call the campus library etc etc.
  454.  
  455. PORTEST2 EXE  Simple and easy to use serial port diagnostic tool that even
  456.               a housewife could learn to use in minutes. Explains it all.
  457.  
  458. READV12  EXE  Nice tool for quickly viewing and reading ascii text files.
  459.               Has several powerful features not even found in Vern's LIST.
  460.  
  461. SAM-V32  EXE  Slick Answer Machine, ideal for notifying users when the
  462.               BBS is down for regular maintenance. Quick to setup an use.
  463.  
  464. VALERT2.EXE   Finally, a safe way to test suspicious software. Easy to
  465.               use, monitors DOS Vector table for potential virus attack.
  466.  
  467. ASAVITV3.EXE  Add a timed auto file save feature to your favorite Editor
  468.               or word processor, can also double as a timed prg execution util.
  469.  
  470. PCLOCKV2.EXE  Stop the kids from messing with the keyboard when you leave
  471.               the terminal for coffee. Easy and quick to both install an use.
  472.  
  473. DIVEFIX2.EXE  Eliminate DOS Divide Error system crashes with this temporary
  474.               DOS patch utility. If you ever had this problem, its over.
  475.  
  476. ABATV2.EXE    A Great way to modify your AUTOEXEC.BAT or CONFIG.SYS without
  477.               any hassle. Quick, easy and accurate every time.
  478.  
  479. ==============================================================================
  480.  
  481.     ACKNOWLEDGEMENTS:
  482.     -----------------
  483.     To one of my best friends and machine code instructor, the Padre,
  484.     alias, Machine Man, whose many patient hours of coaching and prodding
  485.     over the years helped me learn assembler so that I could create this
  486.     and many other useful DOS utility. Also, to a small handful of other
  487.     generous "Elmer's of Assembler" whose contributions over the years
  488.     have helped make my hack more efficient and elegant. Five years ago
  489.     I could not even spell Assnembler, now I are one. Thanks guys!
  490.  
  491.                                 <EOF>
  492.